home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / text2ps.z / text2ps
Encoding:
Text File  |  2002-10-03  |  36.8 KB  |  727 lines

  1.  
  2.  
  3.  
  4. TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      text2ps - convert text files to PostScript
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      tttteeeexxxxtttt2222ppppssss [----pppp filename] [----zzzz filename]
  13.              [----JJJJ printername] [----ssss pageSize] [----FFFF fontName[size]]
  14.              [----FFFF %%%%{aaaa-zzzz}fontName[size]] [----PPPP fontSize]
  15.              [----oooo orientation] [----SSSS pageStyle] [----MMMM numColumns]
  16.              [----wwww lineWrap] [----KKKK maxLines] [----mmmm outputMode]
  17.              [----EEEE headerText] [----llll locale] [----LLLL leftMargin]
  18.              [----RRRR rightMargin] [----BBBB bottomMargin] [----TTTT topMargin]
  19.              [----AAAA allMargins] [----nnnn pageNum] [----xxxx]
  20.              [----eeee reencodeFont] [----iiii prologFile] [----dddd metricsDir]
  21.              [----gggg pageSizeFile] [----hhhh] [----vvvv] [----QQQQ[QQQQ[QQQQ]]]
  22.              [text file ...]
  23.  
  24.      For compatibility with llllppppttttooooppppssss the following options are provided:
  25.  
  26.              [----GGGG] [----NNNN [ttttbbbb][llllccccrrrr]pageNum] [----HHHH]
  27.              [----VVVV] [----UUUU] [----OOOO arg] [----IIII arg]
  28.              [----DDDD] [----CCCC arg] [----XXXX] [----WWWW]
  29.  
  30. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  31.      _t_e_x_t_2_p_s formats text using the PostScript page description language. The
  32.      program provides a wide variety of formatting options including multiple
  33.      column output, page rotation, font selection and page decoration.
  34.  
  35.    TTTTeeeexxxxtttt FFFFiiiilllleeee IIIInnnnppppuuuutttt
  36.      One or more text files can be specified on the command line. If no files
  37.      are specified on the command line, _t_e_x_t_2_p_s will read from the standard
  38.      input. Currently, _t_e_x_t_2_p_s can accept plain text files in a number of
  39.      languages. The program has successfully formatted English, French,
  40.      German, and Russian (cyrillic) text files and theoretically should be
  41.      able to handle any language that can be expressed using an Adobe Type 1
  42.      font in a horizontal writing direction.  _t_e_x_t_2_p_s cannot currently handle
  43.      Adobe Type 0 composite fonts or vertical writing directions.
  44.  
  45.      Besides plain text files, _t_e_x_t_2_p_s can accept text files that contain
  46.      formatting control characters and special escape sequences. The most
  47.      common example of such files are formatted _n_r_o_f_f manual pages.  _t_e_x_t_2_p_s
  48.      has successfully handled the complex formatting produced by the _t_b_l and
  49.      _e_q_n programs. The following control characters and escape sequences are
  50.      recognized by _t_e_x_t_2_p_s:
  51.  
  52.              NNNNaaaammmmeeee        CCCChhhhaaaarrrr   CCCCooooddddeeee   DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  53.              _________________________________________________________
  54.              Null               0x00   No action
  55.              Bell        ^G     0x07   Audible bell
  56.              Backspace   ^H     0x08   Reverse one character
  57.              H Tab       ^I     0x09   Forward to next multiple of 8
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))
  71.  
  72.  
  73.  
  74.              Newline     ^J     0x0A   Start new line
  75.              V Tab       ^K     0x0B   Down one line
  76.              Formfeed    ^L     0x0C   Begin new page or column
  77.              Return      ^M     0x0D   Reverse to start of line
  78.              Shift Out   ^N     0x0E   No action
  79.              Shift In    ^O     0x0F   No action
  80.              Esc                0x1B   Begin escape sequence
  81.              Esc-7                     Reverse full line feed
  82.              Esc-8                     Reverse half line feed
  83.              Esc-9                     Forward half line feed
  84.              Esc-D                     Gaudy header left box text
  85.              Esc-H                     Gaudy header filename area text
  86.              Esc-U                     Gaudy user comment area text
  87.              Esc-F                     Font change sequence
  88.  
  89.      See the SSSSppppeeeecccciiiiaaaallll EEEEssssccccaaaappppeeee SSSSeeeeqqqquuuueeeennnncccceeeessss section below for details on the Esc-D,
  90.      Esc-H, Esc-U and Esc-F sequences.
  91.  
  92.      Control characters and escape sequences not listed above will cause
  93.      _t_e_x_t_2_p_s to issue a warning indicating the offending character and its
  94.      location in the text file. To prevent inadvertently attempting to format
  95.      a binary file, _t_e_x_t_2_p_s will terminate the processing of any file that
  96.      contains more than fifty unrecognized characters unless the ----xxxx option has
  97.      been specified (see below). To ensure the proper processing of text files
  98.      the international locale should be established either by setting the LLLLAAAANNNNGGGG
  99.      environment variable prior to running _t_e_x_t_2_p_s or by using the ----llll command
  100.      line option.
  101.  
  102.    PPPPoooossssttttSSSSccccrrrriiiipppptttt OOOOuuuuttttppppuuuutttt
  103.      _t_e_x_t_2_p_s produces Level 1 PostScript code formatted in compliance with the
  104.      Adobe Document Structuring Conventions, Version 3.0. The output data is
  105.      7-bit clean even when the input data is not.  By default, _t_e_x_t_2_p_s writes
  106.      its PostScript output to the standard output.
  107.  
  108.    CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  109.      The command line option switches for _t_e_x_t_2_p_s are compatible with the
  110.      upper case version of the _l_p_t_o_p_s program option letters. _t_e_x_t_2_p_s provides
  111.      additional functionality typically using lowercase option letters.
  112.  
  113.      ----pppp _f_i_l_e_n_a_m_e
  114.                Specifies the name of the file to which the PostScript output
  115.                will be written.  If the ----pppp option is not specified, output
  116.                will be sent to the standard output.
  117.  
  118.      ----zzzz _f_i_l_e_n_a_m_e
  119.                By default, _t_e_x_t_2_p_s sends its error, warning and information
  120.                messages to the standard error. The ----zzzz option specifies the
  121.                name of a file to which these messages should be redirected. If
  122.                the file specified already exists, any messages generated by
  123.                _t_e_x_t_2_p_s will be appended to the end of the file.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))
  137.  
  138.  
  139.  
  140.      ----JJJJ _p_r_i_n_t_e_r_n_a_m_e
  141.                Specifies the name of a printer for which the text is to be
  142.                formatted.  _p_r_i_n_t_e_r_n_a_m_e is the name of the printer as
  143.                registered with the printer spooling system (see _p_r_i_n_t_e_r_s(1M)
  144.                for information on printer installation). The printer may be
  145.                physically attached to the system or it may be a network
  146.                printer.
  147.  
  148.                Specifying a printer allows _t_e_x_t_2_p_s to obtain detailed printer
  149.                configuration information such as the currently loaded page
  150.                size, available fonts and physical margins. This information is
  151.                used to provide the optimum formatting of the text file for the
  152.                specified printer.
  153.  
  154.                If the ----JJJJ option is not specified, _t_e_x_t_2_p_s assumes a default
  155.                target environment consisting of an A size page with 0.5 inch
  156.                margins. If the resulting PostScript file is subsequently sent
  157.                to a printer whose printing area is smaller than the default,
  158.                the text will be scaled to fit the target page. When scaling is
  159.                performed, the aspect ratio of the original page is maintained.
  160.  
  161.      ----ssss _p_a_g_e_S_i_z_e
  162.                Specifies a page size to use when formatting text. The default
  163.                page size is AAAA (8.5 by 11.0 inches). _p_a_g_e_S_i_z_e may be specified
  164.                either as the name of a page size (e.g. A, B, Ledger, Monarch)
  165.                or explicitly using page dimensions. The syntax for specifying
  166.                page dimensions is <width>x<height>[<units>] where <units> may
  167.                be iiiinnnn, ccccmmmm, mmmmmmmm, pppptttt for inches, centimeters, millimeters and
  168.                points respectively. If <units> is not specified, inches are
  169.                assumed. Thus, a B size page may be specified by setting
  170.                _p_a_g_e_S_i_z_e to BBBB or 11111111xxxx11117777iiiinnnn.
  171.  
  172.                If a printer has not been specified (see ----JJJJ option above),
  173.                _t_e_x_t_2_p_s looks up the dimensions corresponding to a page size
  174.                name in the file /_u_s_r/_l_i_b/_p_r_i_n_t/_d_a_t_a/_t_e_x_t_2_p_s_P_a_g_e_S_i_z_e_s. If a
  175.                printer has been specified, it is queried for the dimensions of
  176.                the specified page size name. If the page size is not supported
  177.                on the printer, the disk based page size table is used.  If a
  178.                page size name is not found on the printer and in the disk
  179.                based table, the default, A size, is used.
  180.  
  181.                Refer to the /_u_s_r/_l_i_b/_p_r_i_n_t/_d_a_t_a/_t_e_x_t_2_p_s_P_a_g_e_S_i_z_e_s for a list of
  182.                the supported page size names and for instructions on how to
  183.                add new page sizes.
  184.  
  185.      ----FFFF _f_o_n_t_N_a_m_e[_s_i_z_e]
  186.                Specifies the font and, optionally, point size to use for the
  187.                body text. The body text is all text on the page excluding the
  188.                page header. The default body font is Courier10. _f_o_n_t_N_a_m_e may
  189.                be any Adobe Font Metric (AFM) file name or one of the font
  190.                name abbreviations listed in the FFFFoooonnnntttt NNNNaaaammmmeeee AAAAbbbbbbbbrrrreeeevvvviiiiaaaattttiiiioooonnnnssss
  191.                section below. By default, _t_e_x_t_2_p_s looks in the directory
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))
  203.  
  204.  
  205.  
  206.                /_u_s_r/_l_i_b/_D_P_S/_A_F_M for font metric files. If the metric file for
  207.                a specified font name cannot be found, the Courier font is
  208.                substituted. If _s_i_z_e is not specified, the default point size
  209.                will be used. The default point size is 10 but may be changed
  210.                using the ----PPPP option. Examples of valid font specifications are
  211.                Courier and Courier14.
  212.  
  213.      ----FFFF %%%%{aaaa-zzzz}_f_o_n_t_N_a_m_e[_s_i_z_e]
  214.                _t_e_x_t_2_p_s allows up to 26 fonts to be registered for later use. A
  215.                font is registered by prefixing the font specification with a %%%%
  216.                and a lower case letter between aaaa and zzzz inclusive. By embedding
  217.                special escape sequences (see section below) in a text file, it
  218.                is possible to dynamically change the font used when formatting
  219.                the file. _t_e_x_t_2_p_s automatically registers the following fonts:
  220.  
  221.  
  222.                      SSSSppppeeeecccciiiiffffiiiiccccaaaattttiiiioooonnnn      PPPPuuuurrrrppppoooosssseeee
  223.                      __________________________________________________
  224.                      %rCourier10        Default body font
  225.                      %hCourier-Bold10   Simple header font
  226.                      %lTimes-Bold12     Gaudy header time/date font
  227.                      %cTimes-Roman14    Gaudy header file pathname font
  228.                      %pHelvetica30      Gaudy header page number font
  229.  
  230.                Note that the %l, %c and %p fonts are registered only when the
  231.                ggggaaaauuuuddddyyyy page style is used.
  232.  
  233.      ----PPPP _f_o_n_t_S_i_z_e
  234.                Specifies the point size to use with fonts that have been
  235.                specified only by name (e.g. Courier as opposed to Courier14).
  236.                The default point size is 10.  Note that all font sizes are
  237.                expressed in units of points. Any units specified as part of
  238.                _f_o_n_t_S_i_z_e will be silently ignored and the value will be assumed
  239.                to be expressed in points.
  240.  
  241.      ----oooo _o_r_i_e_n_t_a_t_i_o_n
  242.                If _o_r_i_e_n_t_a_t_i_o_n is specified as rrrroooottttaaaatttteeee the entire output page
  243.                will be rotated 90 degrees counter-clockwise. Using this
  244.                option, landscape oriented output can be obtained on a portrait
  245.                page. nnnnoooorrrroooottttaaaatttteeee, the default, can be specified to disabled page
  246.                rotation.
  247.  
  248.      ----SSSS _p_a_g_e_S_t_y_l_e
  249.                Specifies the page decoration to be used. One of the following
  250.                values of _p_a_g_e_S_t_y_l_e may be specified:
  251.  
  252.                ppppllllaaaaiiiinnnn     Indicates that no page decoration is to be used. This
  253.                          is the default style.
  254.  
  255.                ppppaaaaggggeeeennnnuuuummmm[,,,,[ttttbbbb][llllccccrrrr]
  256.                          Places a page number at the specified location on the
  257.                          page. The default page number location is at the top,
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))
  269.  
  270.  
  271.  
  272.                          center of the page. A different location can be
  273.                          specified by placing a comma after the ppppaaaaggggeeeennnnuuuummmm value
  274.                          and then specifying a letter sequence. The letters
  275.                          indicate a vertical page position (tttt = top, bbbb =
  276.                          bottom) and a horizontal page position (llll = left, cccc =
  277.                          center, rrrr = right). All letters are optional and may
  278.                          be specified in any order. There must not be any
  279.                          whitespace between the comma and the letters.
  280.  
  281.                hhhheeeeaaaaddddeeeerrrr    Places a simple one line text header at the top of
  282.                          each output page. The header consists of the current
  283.                          date, the current time, the full pathname of the
  284.                          input file, if available, and the page number.
  285.  
  286.                ggggaaaauuuuddddyyyy     Provides the same information as the simple header
  287.                          but in a more graphic layout with additional space
  288.                          for a user supplied comment (see ----EEEE below).  Note
  289.                          that file pathnames too long to fit in the available
  290.                          space will be truncated starting from the left with
  291.                          leading ellipses added in place of the discarded
  292.                          text.
  293.  
  294.      ----MMMM _n_u_m_C_o_l_u_m_n_s
  295.                _t_e_x_t_2_p_s places a single column of text on the page by default.
  296.                The ----MMMM option allows the page to be divided into an arbitrary
  297.                number of columns. Typically, when using more than a single
  298.                column, the font size should be reduced to avoid excessive line
  299.                wrapping. A common use of this option is formatting text in
  300.                landscape orientation for an A size page. In this case two
  301.                columns of seven point Courier type makes excellent use of the
  302.                page.
  303.  
  304.      ----wwww _l_i_n_e_W_r_a_p
  305.                When the length of a line of text is greater than the available
  306.                width of the page or column the remaining text may either be
  307.                discarded (i.e. clipped) or wrapped around to the next line.
  308.                _l_i_n_e_W_r_a_p is either wwwwrrrraaaapppp, the default, which wraps long text
  309.                lines to the next line or cccclllliiiipppp which discards text that does
  310.                not fit on the line.
  311.  
  312.      ----KKKK _m_a_x_L_i_n_e_s
  313.                Normally, _t_e_x_t_2_p_s places as many lines of text on the page as
  314.                will fit (equivalent to specifying _m_a_x_L_i_n_e_s as 0).  The ----KKKK
  315.                option places a maximum limit on the number of lines placed on
  316.                a page or column.  The number of lines actually produced will
  317.                be either _m_a_x_L_i_n_e_s or the number that can fit on the page
  318.                whichever is less. However, if the ----KKKK option is used with the
  319.                ffffiiiitttt mode of the ----mmmm option, the output page is scaled, if
  320.                necessary, to ensure that exactly _m_a_x_L_i_n_e_s number of lines are
  321.                produced on the page. See the ----mmmm option below for more
  322.                information.
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))
  335.  
  336.  
  337.  
  338.      ----mmmm _o_u_t_p_u_t_M_o_d_e
  339.                By default, tttteeeexxxxtttt2222ppppssss places as many lines of text on the page as
  340.                will fit.  This is the nnnnoooorrrrmmmmaaaallll output mode. Certain text files
  341.                such as manual pages have been preformatted with page breaks
  342.                assuming a specific number of lines per page. To ensure the
  343.                proper processing of these files the ----mmmm option should be
  344.                specified with ffffiiiitttt as the _o_u_t_p_u_t_M_o_d_e and the ----KKKK option should
  345.                be specified with the required number of lines per page. The
  346.                typical specification for a manual page would be ----mmmm ffffiiiitttt and ----KKKK
  347.                66666666.
  348.  
  349.      ----EEEE _h_e_a_d_e_r_T_e_x_t
  350.                Specifies a comment to be placed on the page header. If the ----SSSS
  351.                option has specified the hhhheeeeaaaaddddeeeerrrr page style, the _h_e_a_d_e_r_T_e_x_t will
  352.                replace the file pathname. If the ----SSSS option has specified the
  353.                ggggaaaauuuuddddyyyy page style, the _h_e_a_d_e_r_T_e_x_t will be placed above the file
  354.                pathname.
  355.  
  356.      ----llll _l_o_c_a_l_e In order to successfully format a text file _t_e_x_t_2_p_s must know
  357.                the file's language. The language of the text file is conveyed
  358.                by specifying an international locale (see _e_n_v_i_r_o_n(5)). If the
  359.                ----llll option is not specified, the locale is determined by the
  360.                value of the LLLLAAAANNNNGGGG environment variable. If ----llll is specified, the
  361.                locale is set to the value of _l_o_c_a_l_e. The directory
  362.                /_u_s_r/_l_i_b/_l_o_c_a_l_e contains entries for each locale available on
  363.                the system.
  364.  
  365.      ----LLLL _l_e_f_t_M_a_r_g_i_n
  366.      ----RRRR _r_i_g_h_t_M_a_r_g_i_n
  367.      ----BBBB _b_o_t_t_o_m_M_a_r_g_i_n
  368.      ----TTTT _t_o_p_M_a_r_g_i_n
  369.      ----AAAA _a_l_l_M_a_r_g_i_n_s
  370.                Specifies the margins to be used when formatting the page. The
  371.                default _t_e_x_t_2_p_s margin is 0.5 inches on all sides. Margins are
  372.                specified using the syntax <value>[<units>] where <units> may
  373.                be iiiinnnn, ccccmmmm, mmmmmmmm, pppptttt for inches, centimeters, millimeters and
  374.                points respectively. If <units> is not specified, inches are
  375.                assumed. Thus, a 5 centimeter margin would be specified as 5cm.
  376.                The manual setting of margins is discouraged since it disables
  377.                _t_e_x_t_2_p_s's automatic scaling mechanism. If a margin is manually
  378.                specified that is smaller than a printer's physical margins,
  379.                clipping of the output may result. This cannot occur when the
  380.                default _t_e_x_t_2_p_s margins are used. The ----AAAA option is provided as
  381.                a convenience when all four margins are to be set to the same
  382.                value.
  383.  
  384.      ----nnnn _p_a_g_e_N_u_m
  385.                Specifies the starting value for page numbering. The default
  386.                starting page number is 1. _p_a_g_e_N_u_m must be greater than or
  387.                equal to zero. If multiple input text files are processed, each
  388.                will be numbered starting at the specified page number. For
  389.                example, if ----nnnn 3333 is specified and two input text files are
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))
  401.  
  402.  
  403.  
  404.                processed, the pages of each file will be numbered starting at
  405.                3.
  406.  
  407.      ----xxxx        _t_e_x_t_2_p_s recognizes plain text characters, a number of common
  408.                control characters and a set of special escape sequences. All
  409.                other characters cause a warning message to be issued
  410.                identifying the character and its location in the input file.
  411.                If more than 50 characters in a file are unrecognized, the
  412.                processing of that file terminates. This prevents inadvertently
  413.                attempting to format a binary file. If a file is to be
  414.                formatted that contains unrecognizable characters, the ----xxxx
  415.                option should be specified. This silences all unrecognized
  416.                character warnings and allows an unlimited number of
  417.                unrecognized characters to be processed.
  418.  
  419.      ----eeee _r_e_e_n_c_o_d_e_F_o_n_t
  420.                Each character in a text file has a unique code number. These
  421.                code numbers are used to select a character glyph in a font.
  422.                When using only ASCII characters the correspondence of
  423.                character codes to character glyphs is very straight forward.
  424.                However, when formatting text for international locales the
  425.                interpretation of character codes outside the ASCII code range
  426.                becomes an issue. Many commonly used Adobe Type 1 fonts have a
  427.                character code to character glyph mapping that is incorrect for
  428.                many European locales.  _t_e_x_t_2_p_s automatically corrects this by
  429.                reencoding the font to provide the correct character glyphs.
  430.                This automatic reencoding of a font is performed only if that
  431.                font has been encoded using the Adobe Standard Encoding. All
  432.                other font encodings are untouched. Reencoded fonts conform to
  433.                the ISO 8859-1 specification. The ----eeee option can be used to
  434.                disable the automatic reencoding of Adobe Standard Encoding
  435.                fonts.
  436.  
  437.      ----iiii _p_r_o_l_o_g_F_i_l_e
  438.                _t_e_x_t_2_p_s places a PostScript code prolog at the start of the
  439.                output file.  By default, this prolog code is read from the
  440.                file /_u_s_r/_l_i_b/_p_r_i_n_t/_d_a_t_a/_t_e_x_t_2_p_s_P_r_o_l_o_g.  The ----iiii switch allows a
  441.                different prolog file to be specified. This switch is not
  442.                intended for general use.
  443.  
  444.      ----dddd _m_e_t_r_i_c_s_D_i_r
  445.                In order to format text, _t_e_x_t_2_p_s uses Adobe Font Metric (AFM)
  446.                files.  The default location for these files is
  447.                /_u_s_r/_l_i_b/_D_P_S/_A_F_M. When metric information is needed for a font,
  448.                the metrics directory name is prepended to the font name to
  449.                form the full pathname of the AFM file. The ----dddd option allows a
  450.                different directory to be specified for the font metrics.
  451.  
  452.      ----gggg _p_a_g_e_S_i_z_e_F_i_l_e
  453.                _t_e_x_t_2_p_s maintains a file containing page size names and their
  454.                corresponding dimensions. The default page size file is
  455.                /_u_s_r/_l_i_b/_p_r_i_n_t/_d_a_t_a/_t_e_x_t_2_p_s_P_a_g_e_S_i_z_e. The ----gggg option allows a
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))
  467.  
  468.  
  469.  
  470.                different page size file to be specified.
  471.  
  472.      ----hhhh        Prints a program usage message to the standard error.
  473.  
  474.      ----vvvv        Prints a message summarizing the results of formatting the
  475.                specified text.
  476.  
  477.      ----QQQQ        Specifies that detailed runtime processing information is to be
  478.                provided. The more QQQQ's that are specified, the more detailed
  479.                the runtime information.  Currently, up to three QQQQ's provide
  480.                coarse, medium and fine levels of information respectively.
  481.  
  482.      The following command line options are provided only for compatibility
  483.      with the _l_p_t_o_p_s program. Certain options are equivalent to standard
  484.      _t_e_x_t_2_p_s options while others are silently ignored.
  485.  
  486.      ----GGGG        Equivalent to ----SSSS ggggaaaauuuuddddyyyy.
  487.  
  488.      ----NNNN [ttttbbbb][llllccccrrrr]ppppaaaaggggeeeeNNNNuuuummmm
  489.                Equivalent to ----SSSS ppppaaaaggggeeeennnnuuuummmm[,,,,[ttttbbbb][llllccccrrrr]] ----nnnn ppppaaaaggggeeeeNNNNuuuummmm.
  490.  
  491.      ----HHHH        Equivalent to ----oooo rrrroooottttaaaatttteeee.
  492.  
  493.      ----VVVV        Equivalent to ----oooo nnnnoooorrrroooottttaaaatttteeee.
  494.  
  495.      ----UUUU        Ignored.
  496.  
  497.      ----OOOO aaaarrrrgggg    Ignored.
  498.  
  499.      ----IIII aaaarrrrgggg    Ignored.
  500.  
  501.      ----DDDD        Equivalent to ----eeee nnnnoooorrrreeeeeeeennnnccccooooddddeeee
  502.  
  503.      ----CCCC aaaarrrrgggg    Ignored.
  504.  
  505.      ----XXXX        Ignored.
  506.  
  507.      ----WWWW        Equivalent to ----wwww wwwwrrrraaaapppp.
  508.  
  509.    SSSSppppeeeecccciiiiaaaallll EEEEssssccccaaaappppeeee SSSSeeeeqqqquuuueeeennnncccceeeessss
  510.      _t_e_x_t_2_p_s recognizes a number of special escape sequences. These sequences
  511.      can be embedded in a text file to change header text and switch fonts
  512.      during processing of  the file.  The escape sequences are compatible with
  513.      those used by the _e_n_s_c_r_i_p_t program from the Adobe TranScript product. The
  514.      sequences are:
  515.  
  516.               EEEEssssccccaaaappppeeee SSSSeeeeqqqquuuueeeennnncccceeee      DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  517.               _______________________________________________________
  518.               Esc-D(_t_o_p)(_b_o_t_t_o_m)   Gaudy header left box text
  519.               Esc-H_h_e_a_d_e_r_T_e_x_t      Gaudy header filename area text
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))
  533.  
  534.  
  535.  
  536.               Esc-U_c_o_m_m_e_n_t_T_e_x_t     Gaudy user comment area text
  537.               Esc-F_c               Font change sequence where _c
  538.                                    is the letter of a font registered
  539.                                    using ----FFFF %%%%{aaaa-zzzz} _f_o_n_t_N_a_m_e[_s_i_z_e]
  540.  
  541.    FFFFoooonnnntttt NNNNaaaammmmeeee AAAAbbbbbbbbrrrreeeevvvviiiiaaaattttiiiioooonnnnssss
  542.      _t_e_x_t_2_p_s accepts the following font name abbreviations. These
  543.      abbreviations are identical to those used by the _l_p_t_o_p_s program.
  544.  
  545.               FFFFuuuullllllll NNNNaaaammmmeeee                      AAAAbbbbbbbbrrrreeeevvvviiiiaaaattttiiiioooonnnn
  546.               ______________________________________________________
  547.               Courier                        C
  548.               Courier-Bold                   CB
  549.               Courier-BoldOblique            CBO
  550.               Courier-Oblique                CO
  551.               Helvetica                      H
  552.               Helvetica-Bold                 HB
  553.               Helvetica-BoldOblique          HBO
  554.               Helvetica-Oblique              HO
  555.               Symbol                         S
  556.               Times-Bold                     TB
  557.               Times-BoldItalic               TBI
  558.               Times-Italic                   TI
  559.               Times-Roman                    T
  560.               AvantGarde-Book                AGB
  561.               AvantGarde-BookOblique         AGBO
  562.               AvantGarde-Demi                AGD
  563.               AvantGarde-DemiOblique         AGDO
  564.               Bookman-Demi                   BD
  565.               Bookman-DemiItalic             BDI
  566.               Bookman-Light                  BL
  567.               Bookman-LightItalic            BLI
  568.               Helvetica-Narrow               HN
  569.               Helvetica-Narrow-Bold          HNB
  570.               Helvetica-Narrow-BoldOblique   HNBO
  571.               Helvetica-Narrow-Oblique       HNO
  572.               NewCenturySchlbk-Bold          NCSB
  573.               NewCenturySchlbk-BoldItalic    NCSBI
  574.               NewCenturySchlbk-Italic        NCSI
  575.               NewCenturySchlbk-Roman         NCSR
  576.               Palatino-Bold                  PB
  577.               Palatino-BoldItalic            PBI
  578.               Palatino-Italic                PI
  579.               Palatino-Roman                 PR
  580.               ZapfChancery-MediumItalic      ZCMI
  581.               ZapfDingbats                   ZD
  582.  
  583. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  584.      1.   Formatting a manual page:
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))
  599.  
  600.  
  601.  
  602.           pcat csh.z | text2ps -K 66 -m fit > csh.ps
  603.  
  604.  
  605.      2.   Formatting a file using a 14 point Helvetica font:
  606.  
  607.           text2ps -F Helvetica14 /etc/passwd > passwd.ps
  608.  
  609.  
  610.      3.   Formatting a file for two column, landscape oriented output on the
  611.           printer 'dj':
  612.  
  613.           text2ps -J dj -o rotate -M 2 -F Courier7 /etc/passwd | lp -ddj
  614.  
  615.  
  616. NNNNOOOOTTTTEEEESSSS
  617.      1.   The _t_e_x_t_2_p_s program supersedes the _l_p_t_o_p_s program. The _l_p_t_o_p_s
  618.           program should not be used for new development and may be removed
  619.           from future releases.
  620.  
  621.      2.   The PostScript output produced by _t_e_x_t_2_p_s conforms to the Adobe
  622.           PostScript Document Structuring Conventions Version 3.0 as specified
  623.           in Appendix G of the "PostScript Language Reference Manual", 2nd
  624.           edition.
  625.  
  626.      3.   If _t_e_x_t_2_p_s is given an unrecognized or incomplete command line
  627.           option switch, it will print a warning message to the standard
  628.           error, ignore the option and continue processing.
  629.  
  630.      4.   If a file is specified on the command line, _t_e_x_t_2_p_s will not read
  631.           its stdin for text files.
  632.  
  633.      5.   _t_e_x_t_2_p_s can only process a single file when reading from standard
  634.           input.
  635.  
  636.      6.   Use a of proportional spaced font or dynamically changing fonts when
  637.           formatting manual pages can cause misformatting of tables.
  638.  
  639.      7.   For compatibility with the _l_p_t_o_p_s program, the units of _b_i_g _p_o_i_n_t_s
  640.           may be specified using bbbbpppp for the page size and margin options.
  641.           _t_e_x_t_2_p_s treats big points equal to points (pppptttt).
  642.  
  643.      8.   _t_e_x_t_2_p_s uses command line option letters which violate the
  644.           Impressario _F_i_l_t_e_r-_D_r_i_v_e_r _S_p_e_c_i_f_i_c_a_t_i_o_n. This is done to provide
  645.           compatibility with the _l_p_t_o_p_s program.
  646.  
  647. FFFFIIIILLLLEEEESSSS
  648.      /usr/lib/print/text2ps                  Program file
  649.      /usr/lib/print/data/text2psProlog       PostScript prolog file
  650.      /usr/lib/print/data/text2psPageSizes    Page size name and dimension
  651.                                              table
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                                                        PPPPaaaaggggeeee 11110000
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEEXXXXTTTT2222PPPPSSSS((((1111))))
  665.  
  666.  
  667.  
  668.      /usr/lib/DPS/AFM                        Font metric files
  669.  
  670. TTTTRRRRAAAADDDDEEEEMMMMAAAARRRRKKKKSSSS
  671.      PostScript is a registered trademark of Adobe Systems, Inc.
  672.  
  673. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  674.      imprint(1), psrip(1), _P_o_s_t_S_c_r_i_p_t _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l - 2nd ed.,
  675.      Adobe Systems, Inc.  environ(5)
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                                                                        PPPPaaaaggggeeee 11111111
  724.  
  725.  
  726.  
  727.